home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 283_03 / readme2.doc < prev    next >
Encoding:
Text File  |  1988-12-16  |  8.0 KB  |  173 lines
  1.  
  2. BURLAP.EXE - Version 2, 12/4/88, by David C. Oshel
  3. ---------------------------------------------------
  4.  
  5. BURLAP is a *fast* mailing list maintenance program.  Speed and convenience
  6. of operation is due largely to Faircom's c-tree(TM) ISAM file management,
  7. but I will accept a few kudos for grace notes of my own.  In general terms,
  8. I developed BURLAP's user interface for my own convenience, since I use
  9. this program personally to maintain a good-sized mailing list for a 
  10. professional journal, and since I do not like programs that hinder
  11. efficiency in a dull, repetitive task.  BURLAP is ironically named -- the
  12. program in action is smooth as silk.
  13.  
  14.  
  15. Discussion:
  16.  
  17.      (a) Distributed files
  18.  
  19.           * BURLAP.EXE  -  mailing list manager
  20.           * BURLAP.S    -  default screen image file
  21.  
  22.      (b) Files created by BURLAP.EXE
  23.  
  24.           * BURLAP.P    -  default c-tree(tm) ISAM parameters, text file
  25.           * BURLAP.DT   -  default c-tree(tm) ISAM data, binary file
  26.           * BURLAP.IX   -  default c-tree(tm) ISAM index, binary file
  27.  
  28.           * BURLAP.ASC  -  Export/Import comma-delimited ASCII file
  29.           * $.          -  Result file when writing an address label
  30.           * BURLAP.CFG  -  Screen colors and snow flag save/restore file
  31.  
  32.      (c) Optional user file, created by using a text editor
  33.  
  34.           * BURLAP.M    -  default record selection macro
  35.  
  36.      (d) Advanced topic
  37.  
  38.           * Once created, the BURLAP.* files may all be renamed, and
  39.             the parameter file edited to refer to the renamed .DT and
  40.             .IX files.  Do not alter anything in a .P file except for
  41.             the path names of the data and index files.
  42.  
  43.           * Alternate .P, .S, and .M pathnames may be specified on the
  44.             command line, as discussed.  Order is not significant.
  45.  
  46. Usage:  C>burlap {screenfilepath}.s {parameterfilepath}.p {macrofilepath}.m
  47.  
  48. Examples: C>burlap john.s john.p john.m
  49.           C>burlap myfile.s c:\app2\myfile.p
  50.  
  51.  
  52. Optional command line arguments:
  53.  
  54. BURLAP v. 2.0 takes up to three optional command line arguments, which
  55. are path names to up to three special files in any order.  
  56.  
  57.  .S  * The screen file must be a 4000 byte screen dump created 
  58.        with ES.EXE, with .S suffix.  THIS FILE MUST BE PRESENT.
  59.        If not overridden by a command line argument, BURLAP will
  60.        expect to find BURLAP.S in the current subdirectory.
  61.  
  62.  .P  * The parameter file must end in .P, and will be created 
  63.        if necessary and if possible.  
  64.  
  65.  .M  * The macro file must end in .M, and contains a 256-byte 
  66.        image of BURLAP's default record selection macro.
  67.        
  68. The macro file is loaded, if present, on startup and when you call
  69. the labels routine.  The default macro file may be any length, but
  70. only the first 256 bytes and first four lines are significant.  The
  71. macro file is created with a text editor.
  72.  
  73. If no arguments are given on the command line, BURLAP defaults to NO
  74. default macro, and to the BURLAP.S screen and BURLAP.P parameter file.
  75. BURLAP will create BURLAP.DT and BURLAP.IX concurrently with BURLAP.P,
  76. in the current subdirectory, if these files are not already present.
  77.  
  78. Note that BURLAP.P gives the PATH names to .DT and .IX files; these
  79. names can be edited to refer to any subdirectory on your hard disk.
  80.  
  81.  
  82. File structure:
  83.  
  84. BURLAP data files contain 12 variable-length text fields.  The first 8 of
  85. these fields are organized as the fields of a standard 5-line business
  86. mailing label.  The next 4 fields are not defined in BURLAP, but may
  87. be used for any purpose, such as to contain key words for selecting
  88. mailing labels to be printed.
  89.  
  90. The BURLAP.S screen image names the 4 undefined fields as Salutation,
  91. Home and Work phone numbers, and a comment field.  By editing BURLAP.S,
  92. using ES.EXE, these four fields can be renamed and co-opted to any other
  93. purpose.  The underlying variable-length text data type is not changed.
  94.  
  95.  
  96. Miscellaneous topics:
  97.  
  98. Be sure not to run EXEPACK on BURLAP, or you will make the printer
  99. patch area illegible to disk zap utilities.  The patch area, viewed
  100. under Norton Utilities or PC-Tools, etc., is clearly marked with
  101. suitable neon signs.  Look for "Printer patch area".
  102.  
  103. BURLAP is configured for the Panasonic KX-P1091 printer.  Labels are
  104. printed on standard 3-1/2" by 1" gummed labels.  Lines longer than 30
  105. pica characters will be condensed, first to the elite font, then to
  106. the 17 cpi compressed-mode font.  Lines which print within 30
  107. characters use the Panasonic's Near Letter Quality pica font.  I
  108. *think* these are the same codes used by the Epson LQ-1500 printer.
  109.  
  110. BURLAP's mode of operation is painfully obvious and needs no
  111. introduction beyond the on-screen helps, except as noted:
  112.  
  113. BURLAP does have one "user surly" feature:  It selects records using
  114. Polish notation; i.e., the syntax is like Lisp, or the Brief editor's
  115. macro language.  This is a tradeoff.  The BURLAP macro interpreter is
  116. reasonably fast, in action, and is MUCH easier to code than a more
  117. "natural" user interface.  Who knows?  People have used Hewlett
  118. Packard calculators for years for the exact same reason.  Maybe it'll
  119. catch on.  The macros ARE powerful, and properly phrased can select
  120. records on very complex criteria, even making numerical comparisons
  121. when these are more appropriate than the lexical.  Press F10 for
  122. complete exegesis; there are only four rules of formation.
  123.  
  124. I call this a "toy" program, because its main purpose was to allow me
  125. to explore FairCom's c-tree(TM).  However, I use it "on the side" to
  126. maintain the mailing list of a professional journal, so it is hardly
  127. a trivial exercise.  I find that BURLAP does the job faster and more
  128. conveniently than similar applications I have developed in R:Base and
  129. dBase, courtesy of c-tree(TM) ISAM file management.  In my opinion,
  130. BURLAP's record selection macros are more convenient and more
  131. expressive than what is possible in most professional "procedural"
  132. languages.
  133.  
  134. BURLAP maintains variable-length records.  Older files which have 
  135. become somewhat fragmented can be packed by Exporting the data to an
  136. ASCII file, deleting the ISAM files, then Importing the ASCII file.
  137. These options are all on the utility menu.
  138.  
  139. My apologies to whomever owns the ROLODEX(tm) trade name.  ROLODEX(tm)
  140. is, of course, a desktop accessory whose name is protected by law,
  141. and not a generic term for any and all similar products.  In any case,
  142. BURLAP.EXE is only an intangible electronic wiff, not made of
  143. plastic, and it comes free.  Can a computer program actually compete
  144. with a tangible, hard-as-Bakelite, roll-top, durable good?
  145.  
  146. For these reasons, however, what I called ROLODEX during development
  147. is actually called "My Mailing Labels Program", and is distributed
  148. under the inoffensive, noncompetitive, nom de fromage BURLAP.
  149.  
  150. If you want the source code, send me $15 or $14.99 or so, to cover
  151. the expense of materials and gratuitous aggravation on a dizzy bay,
  152. and I'll ship it off to you -- WITHOUT, of course, including
  153. FairCom's libraries!  If you want THOSE, and what real C programmer
  154. doesn't, spend the modest fraction of a kilobuck it'll cost you; it's
  155. worth it.
  156.  
  157. Do not remove the notice that FairCom wrote and owns the non-royalty
  158. part of my program.  Just because I'm crazy enough to give away a
  159. tool it took me six months to develop doesn't mean they are.
  160.  
  161. Please note that my non-disclosure license with Faircom for the use of
  162. c-tree(TM) in my own programs does not preclude my giving away my own
  163. efforts.  No Faircom source code is included, and BURLAP does not include
  164. any portion of c-tree(TM) which would require a royalty payment (such as 
  165. support for the Novell network).  Users of BURLAP may consider that they
  166. have a non-exclusive license to use BURLAP and all its features, but they
  167. should NOT conclude that Faircom's ISAM file management routines are thereby 
  168. placed in the public domain.  I am happy to give Faircom credit for a
  169. very nice programmer's program, and even happier to share its benefits with
  170. you in this one small way.
  171.  
  172.  
  173.